home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / wildcat / putdesc.zip / PUTDESC.DOC < prev    next >
Text File  |  1992-02-19  |  5KB  |  105 lines
  1. PUTDESC     (c) 1992             Karl Schneider
  2.                                  S & H Engineering
  3.                                  8505 Woodwick Ct.
  4.                                  Tampa, FL 33615
  5.                                  813-884-9661 voice day/eve
  6.                                               bbs midnite-0600 EST
  7.  
  8.                          REVISION HISTORY
  9.  
  10. --------------------------------------------------------------------
  11. 2-19-92 UPDATE: Now can create a FILE_ID.DIZ file in addition
  12. to DESC.SDI, if desired!
  13. --------------------------------------------------------------------
  14. 2-9-92 UPDATE:  Now allows inserting description into .ARJ and .LZH
  15. archives as well as .ZIPs.
  16. --------------------------------------------------------------------
  17. 12-5-91:  Putdesc now retains the ORIGINAL DATE of the .ZIP file.
  18. --------------------------------------------------------------------
  19.  
  20. vvvvvvvvvvvvvvvvvvvvvvv NOTICE! vvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvv
  21.  
  22. 11/24/91:  MAJOR CHANGE.  PUTDESC now adds a file called DESC.SDI to
  23. the .ZIP file.  WC3DESC is no longer supported by AUTODESC!
  24.  
  25. ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  26. 11/16/91. Minor revision:  added code to display any EXISTING des-
  27. cription file with option to leave as-is or change.
  28. ---------------------------------------------------------------------
  29.  
  30.                         ABOUT THE PROGRAM
  31.  
  32. PUTDESC is a fast and easy way to create a DESC.SDI 'description'
  33. file in a .ZIP, .ARJ or .LZH archive which can be used by WILDCAT
  34. 3.0+ BBS systems using AUTODESC. Other BBS systems can also utilize the
  35. stored descriptions, Pcboard is one of them.
  36. You may also create a FILE_ID.DIZ description file whose format
  37. matches that used by PCboard systems.
  38.  
  39. Note that my AUTODESC as of 11/24/91 now supports both DESC.SDI and
  40. FILE_ID.DIZ description files.  It first looks for DESC.SDI, and if
  41. it's not found, will then use FILE_ID.DIZ if it exists.
  42.  
  43. Usage is simply:     putdesc d:\path\archive[.zip | .arj | .lzh] [nobell]
  44.  
  45. The extension is optional.  If it is not used, PUTDESC will search for
  46. .ZIP first, .ARJ second, and .LZH third.  If no match for any of these
  47. 3 is found in the target drive\directory, it will tell you.
  48.  
  49. if you add 'nobell' after the archive filepath, the bell will not
  50. sound on the FILE_ID.DIZ editing screen when the cursor tries to get
  51. out of the displayed limits.
  52.  
  53. If there is already a DESC.SDI file in the archive, it will be
  54. displayed and you can press ESC to leave it as is, or <enter> to
  55. continue and change it.
  56.  
  57. A 60-character bracket will be shown, and the description is typed
  58. in.  Backspace & left arrow keys can be used for editing.  Once the
  59. 60th character is reached, further input is disallowed.  The program
  60. is intuitive and simple.  It adds DESC.SDI to the archive file
  61. specified.
  62.  
  63. After this DESC.SDI has been created (or skipped, at your option), the
  64. program will ask if you want to make a FILE_ID.DIZ.  If you respond
  65. Yes, you will have a 12x45 character field to enter the description
  66. into.  Standard editing keys may be used, (up,down,right,left arrows,
  67. Home, PgUP, PgDN, backspace, etc.)  Pcboard will accept up to
  68. 15 lines, but I have limited it to 12, since some upload 'scanning'
  69. programs add extra information at the end.
  70.  
  71. PKZIP and PKUNZIP must be available for running in whatever directory that
  72. PUTDESC is executed from...in the current directory or in your DOS PATH.
  73.  
  74. If you want to use PUTDESC with .ARJ or .LZH archives, you ALSO MUST
  75. HAVE LHARC.EXE and/or ARJ.EXE in your path.  If you use a later LHARC
  76. that is named LHA.EXE, you must either rename it to LHARC.EXE or copy
  77. it to a file with that name, in your PATH.
  78.  
  79. PUTDESC.EXE also must be in the cwd or your path.
  80.  
  81. After you have added the description file, you can upload the Zipfile to
  82. a Wildcat 3.0+ BBS that uses AUTODESC, in which case you can skip
  83. typing in the description on-line after the upload.  Unfortunately,
  84. it is not at this time possible to support the 'Additional' file
  85. description; that, if needed, will still have to be manually typed
  86. (or done via ASCII upload from a separate text file).  I hope to be
  87. able to support this soon.
  88.  
  89. The description in an archive can be changed if necessary with PUTDESC,
  90. it will re-write DESC.SDI inside the archive with whatever you enter.
  91.  
  92. I've checked this program pretty carefully and have observed no
  93. problems, however, I make no warranties, expressed or implied, con-
  94. cerning its usability or use.  Any comments, bug reports, or suggestions
  95. are welcome.   If you use PUTDESC, I request a nominal regis-
  96. tration to be paid for its use.  $5 or $10 is suggested; if you wish
  97. to, you can contribute $35 or more which will cover full registration
  98. for ALL my Wildcat 3.x utilities (if you need them).  That's under
  99. a dollar apiece!
  100.  
  101. Thanks.
  102.  
  103. -eof-
  104.  
  105.